IRIX Base Documentation 2001 May/SGI IRIX Base Documentation 2001 May.iso/usr/share/catman/p_man/cat3/Vk/VkSubProcessRep.z/VkSubProcessRep

Text File | 2001-04-17 | 8.5 KB | 265 lines

VVVVkkkkSSSSuuuubbbbPPPPrrrroooocccceeeessssssssRRRReeeepppp((((3333xxxx))))                                        VVVVkkkkSSSSuuuubbbbPPPPrrrroooocccceeeessssssssRRRReeeepppp((((3333xxxx))))



NNNNAAAAMMMMEEEE
     VkSubProcess, VkSubProcessRep - Object-oriented interface to a running
     subprocess

IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
     VkSPCounted : VkCallbackObject :

HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
     #include <Vk/VkSubProcess.h>

PPPPUUUUBBBBLLLLIIIICCCC PPPPRRRROOOOTTTTOOOOCCCCOOOOLLLL SSSSUUUUMMMMMMMMAAAARRRRYYYY
   CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrr////DDDDeeeessssttttrrrruuuuccccttttoooorrrr
           static VkSubProcess create(char* cmd,
                                      int killChildOnExit,
                                      int redirectIn);


   AAAAcccccccceeeessssssss FFFFuuuunnnnccccttttiiiioooonnnnssss
           pid_t pid(void);
           int exitStatus(void);
           int stdinfd(void);
           VkPipe* getStdoutPipe(void);
           VkPipe* getStderrPipe(void);


   CCCCoooonnnnttttrrrroooollll FFFFuuuunnnnccccttttiiiioooonnnnssss
           void signal(int sig);
           void kill(int sig = SIGTERM);
           void run(void);




CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     The VkSubProcessRep class is the actual reference-counted class created
     by VkSubProcess.  It represents a running subprocess, and gives the
     application control and access to its output.



FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
   ccccrrrreeeeaaaatttteeee(((())))
           static VkSubProcess create(char* cmd,
                                      int killChildOnExit,
                                      int redirectIn);


          Creates a VkSubProcess.  The first argument is the command to be
          executed, the second argument controls whether the child should be
          killed whenever the parent goes away, and the last argument
          indicates whether to create an input pipe.  Use the run() method to
          actually start the subprocess.



                                                                        PPPPaaaaggggeeee 1111






VVVVkkkkSSSSuuuubbbbPPPPrrrroooocccceeeessssssssRRRReeeepppp((((3333xxxx))))                                        VVVVkkkkSSSSuuuubbbbPPPPrrrroooocccceeeessssssssRRRReeeepppp((((3333xxxx))))



   ppppiiiidddd(((())))
          pid_t pid(void);


          Returns the process ID of a running subprocess.  If the subprocess
          has not been created or isn't running yet, returns 0.

   eeeexxxxiiiittttSSSSttttaaaattttuuuussss(((())))
          int exitStatus(void);


          Returns the last exit status of the subprocess.  Call this method
          after the exitCallback has been called, indicating that the
          subprocess has exited.

   ssssiiiiggggnnnnaaaallll(((())))
          void signal(int sig);


          Send a signal to a running subprocess.

   kkkkiiiillllllll(((())))
          void kill(int sig = SIGTERM);


          Kill a running subprocess.  The default signal sent is SIGTERM.

   ssssttttddddiiiinnnnffffdddd(((())))
          int stdinfd(void);


          Returns the input file descriptor.  This will only be valid if
          redirectIn was set to TRUE in the constructor.

   ggggeeeettttSSSSttttddddoooouuuuttttPPPPiiiippppeeee(((())))
          VkPipe* getStdoutPipe(void);


          Returns the stdout pipe.

   ggggeeeettttSSSSttttddddeeeerrrrrrrrPPPPiiiippppeeee(((())))
          VkPipe* getStderrPipe(void);


          Returns the stderr pipe.

   rrrruuuunnnn(((())))
          void run(void);







                                                                        PPPPaaaaggggeeee 2222






VVVVkkkkSSSSuuuubbbbPPPPrrrroooocccceeeessssssssRRRReeeepppp((((3333xxxx))))                                        VVVVkkkkSSSSuuuubbbbPPPPrrrroooocccceeeessssssssRRRReeeepppp((((3333xxxx))))



          Starts the subprocess created in the constructor.

   VVVVkkkkSSSSuuuubbbbPPPPrrrroooocccceeeessssssssRRRReeeepppp(((())))
          VkSubProcessRep(const char* prog, char** argv,
                          int killChildOnExit, int redirectIn);


          Creates a subprocess.  The first argument is the program name, the
          second is the list of arguments, the third specifies if the
          subprocess should be killed whenever the application goes away, and
          the last indicates that a stdin pipe should be created.

   ~~~~VVVVkkkkSSSSuuuubbbbPPPPrrrroooocccceeeessssssssRRRReeeepppp(((())))
          virtual void ~VkSubProcessRep(void);


          Destroys the VkSubProcess object and closes any pipes to a running
          subprocess object.

IIIINNNNHHHHEEEERRRRIIIITTTTEEEEDDDD MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
   IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm VVVVkkkkSSSSPPPPCCCCoooouuuunnnntttteeeedddd
           VkSPCounted(),  ~VkSPCounted(),


   IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm VVVVkkkkCCCCaaaallllllllbbbbaaaacccckkkkOOOObbbbjjjjeeeecccctttt
          callCallbacks(),  VkCallbackObject(),  ~VkCallbackObject(),
          className(),  addCallback(), addCallback(),  removeCallback(),
          removeCallback(),  removeAllCallbacks(),  removeAllCallbacks(),
          hasCallbacks(),  cloneCallbacks(),  cloneCallback(),
          cloneCallback(),


VVVVIIIIEEEEWWWWKKKKIIIITTTT 2222....1111 CCCCHHHHAAAANNNNGGGGEEEESSSS
   CCCCoooonnnnttttrrrroooollll FFFFuuuunnnnttttiiiioooonnnnssss
           void run(VkScreen *screen);


          this additional API provides support for multi-screen
          applications...

CCCCLLLLAAAASSSSSSSSEEEESSSS UUUUSSSSEEEEDDDD BBBBYYYY TTTTHHHHIIIISSSS CCCCLLLLAAAASSSSSSSS
     VkApp, VkCallbackObject, VkDialogManager, VkPipe

KKKKNNNNOOOOWWWWNNNN CCCCLLLLAAAASSSSSSSSEEEESSSS TTTTHHHHAAAATTTT UUUUSSSSEEEE TTTTHHHHIIIISSSS CCCCLLLLAAAASSSSSSSS
     VkProgram

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     VkCallbackObject, VkPipe, VkProgram
     _V_i_e_w_K_i_t _P_r_o_g_r_a_m_m_e_r'_s _G_u_i_d_e
     _T_h_e _X _W_i_n_d_o_w _S_y_s_t_e_m, DEC Press, Bob Sheifler and Jim Gettys
     _T_h_e _X _W_i_n_d_o_w _S_y_s_t_e_m _T_o_o_l_k_i_t, DEC Press, Paul Asente and Ralph Swick
     _T_h_e _O_S_F/_M_o_t_i_f _P_r_o_g_r_a_m_m_e_r_s _R_e_f_e_r_e_n_c_e, Prentice Hall, OSF



                                                                        PPPPaaaaggggeeee 3333






VVVVkkkkSSSSuuuubbbbPPPPrrrroooocccceeeessssssssRRRReeeepppp((((3333xxxx))))                                        VVVVkkkkSSSSuuuubbbbPPPPrrrroooocccceeeessssssssRRRReeeepppp((((3333xxxx))))























































                                                                        PPPPaaaaggggeeee 4444